home *** CD-ROM | disk | FTP | other *** search
/ Clickx 115 / Clickx 115.iso / software / tools / windows / tails-i386-0.16.iso / live / filesystem.squashfs / usr / share / doc / usb-modeswitch-data / README < prev   
Encoding:
Text File  |  2012-08-12  |  3.8 KB  |  124 lines
  1. README for USB_ModeSwitch Data
  2.  
  3.  
  4. For up-to-date and detailed information (plus a friendly forum) visit
  5. http://www.draisberghof.de/usb_modeswitch
  6.  
  7. PLEASE REPORT NEW DEVICES !
  8.  
  9.  
  10.  
  11. This is a data package to complement the full release package of
  12. USB_ModeSwitch, a tool to switch multi-mode USB devices.
  13. It is used since usb-modeswitch version 1.0.3.
  14.  
  15. Recommended version of usb-modeswitch package is 1.1.4 and above. Some
  16. devices contained here may not be switched with older versions, even if
  17. they will not cause any error.
  18.  
  19.  
  20. Tasks initiated by the rules file:
  21. ==================================
  22.  
  23. - call wrapper to initiate switching for known devices when plugged in
  24.   (starting from version 1.1.4 at boot time too)
  25.  
  26. - adding symlink "gsmmodem" to appropriate connection port (out of 2-5
  27.   ports provided by some devices); this is only a help for handling and
  28.   NOT needed for switching to work.
  29.   This action will be done for known modems only (at least switched once
  30.   on this system)
  31.  
  32. - loading and binding the "option" driver if the device arrives in modem
  33.   state (not CDC/ACM!) and the device ID is not yet known to the driver.
  34.   This action will be done only for modems known to the system (at least
  35.   switched once)
  36.  
  37.  
  38. Explanation about config file names:
  39. ====================================
  40.  
  41. Names consist of <VendorID>:<ProductID>, respective to the default device
  42. mode.
  43. Should more detailed identification become necessary, one or more attributes
  44. to test can be attached after further colons:
  45. <VendorID>:<ProductID>:<Attribute>=<String>[:<Attribute>=<String> ...]
  46.  
  47. The strings match if they are part of the attribute content. Use "_"
  48. to match spaces (it will match "_" too!).
  49.  
  50. Currently recognized attibutes are:
  51.  
  52. uMa = USB, iManufacturer
  53. uPr = USB, iProduct
  54. uSe = USB, iSerial
  55. sVe = SCSI, Vendor
  56. sMo = SCSI, Model
  57. sRe = SCSI, Revision
  58.  
  59. This list is easily extendable if necessary.
  60.  
  61. Example:
  62. <vid>:<pid>:uPr=CDMA_Mo will match iProduct "CDMA Modem" or "MyCDMA_Mordor"
  63.  
  64.  
  65.  
  66. Parameters used only in config files:
  67. =====================================
  68.  
  69. These are not evaluated by the binary but by the wrapper.
  70.  
  71. WaitBefore=<seconds>        delay the switching process
  72.  
  73. DriverModule=<module name>    load a specific driver module after switch
  74.  
  75. DriverIDPath=<path to attribute>
  76.                 if the driver has the ability to add new device IDs
  77.                 on-the-fly, this is the file node to use.
  78.                 Example: "/sys/bus/usb-serial/drivers/option1/new_id"
  79.  
  80.  
  81.  
  82. Notes about specific devices:
  83. =============================
  84.  
  85. - 1004:607f (LG KP500): switching message derived from report but untested
  86.  
  87. - 1266:1000 (Royaltek Q110): switching method very likely but unconfirmed
  88.  
  89. - 1a8d:1000 (BandLuxe): now just one config for all devices; the new parameter
  90.   "ReleaseDelay" will improve ambiguous behaviour on older systems
  91.  
  92. - Some WiMAX and LTE devices are included since 20101222; for most of these
  93.   drivers are work in progress or not available yet. Efforts are underway.
  94.   Stand by or search for "staging drivers".
  95.  
  96. - 05c6:2000 (unnamed HSDPA modem from "dealextreme"): unusually long switching
  97.   time, even with MS Windoze - 30 to 40 seconds. Don't be alarmed.
  98.  
  99. - 0471:1210 (Philips chipset): had to be split after variants with different
  100.   targets and behaviour appeared. This is not properly tested yet, please
  101.   report problems.
  102.  
  103.  
  104. Legal
  105. =====
  106.  
  107. This program is free software; you can redistribute it and/or modify it under
  108. the terms of the GNU General Public License as published by the Free Software
  109. Foundation; either version 2 of the License, or (at your option) any later
  110. version.
  111.  
  112. This program is distributed in the hope that it will be useful, but WITHOUT ANY
  113. WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
  114. PARTICULAR PURPOSE.  See the GNU General Public License for more details:
  115.  
  116. http://www.gnu.org/licenses/gpl.txt
  117.  
  118. Or find it as the file COPYING in this folder.
  119.  
  120.  
  121.  
  122.  
  123. Last revised: 2012-08-12, Josua Dietze
  124.